Dialog: Eingabekonfiguration

Symbol:

Funktion: Der Dialog ermöglicht Ihnen einem Eingabeereignis eine Eingabeaktion zuzuweisen und die Eingabeaktion zu konfigurieren.

Aufruf: Schaltfläche Konfigurieren in Eigenschaft Eingabekonfiguration

Voraussetzung: Im Editor ist ein Element selektiert.

Sind alle Elementeigenschaften verfügbar?

Nur wenn Sie in der Eigenschaften die Option Advanced oder den Filter Alle Kategorien aktiviert haben, stehen Ihnen alle Eigenschaften zur Verfügung.

Eingabeaktion: Benutzerverwaltung

Dialoge und Aktionen	Konfiguriert, welcher der möglichen Benutzerverwaltungsdialoge oder welche Aktion auf das Eingabeereignis folgt Anmerkung Welcher Dialog zur Laufzeit verwendet wird, ist im Visualisierungsmanager in Registerkarte Dialogeinstellungen eingestellt. . Siehe dort Dialog Einloggen Dialog Passwortänderung Dialog Konfigurationsänderung Voreingestellt sind Dialoge aus der Bibliothek `VisuUserManagement`
Anmelden	Eingabeaufforderung für das Anmelden öffnet sich Voreinstellung: `VisuUserManagement.VUM_Login` in Dialog Einloggen
Abmelden	Aktueller Benutzer wird abgemeldet
Benutzerpasswort ändern	Dialog für Passwortänderung öffnet sich Voreinstellung: `VisuUserManagement.VUM_ChangePassword` in Dialog Passwortänderung
Benutzerverwaltung öffnen	Dialog für Konfigurationsänderung öffnet sich Voreinstellung: `VisuUserManagement.VUM_UserManagement` in Dialog Konfigurationsänderung

Eingabeaktion: Dialog schließen

Dialog

Visualisierung (Typs Dialog), die geschlossen werden wird

: Auswahlliste aller im Projekt verfügbaren Visualisierungen des Typs Dialog

Beispiel:

. Standarddialoge der BibliothekVisuDialogs, die üblicherweise im Projekt eingebunden ist.

FileOpenSave
Keypad
Login
Numpad
NumpadExtended
TextinputWithLimits

Anmerkung

Ob eine Visualisierung als Dialog verwendet werden kann, ist in ihrer Objekteigenschaft in Registerkarte Visualisierung eingestellt.

Ergebnis	Rückgabewert, mit dem der Dialog geschlossen wird Anmerkung Wenn auf das Schließen hin weitere Eingabeaktionen folgen, sind diese in der Eigenschaft Eingabekonfiguration → OnDialogClosed des Elements konfiguriert.
Kein	: Kein Rückgabewert
OK	: Der aktivierte Rückgabewert wird zurückgeliefert. Der Rückgabewert verweist auf die Schaltfläche im Dialog: Bei der OK-Schaltfläche wird der Wert `OK` zurückgeliefert. Die Schaltfläche für Abbrechen liefert den Wert `Cancel` zurück.
Abbrechen
Beenden
Erneut versuchen
Ignorieren
Ja
Nein

Eingabeaktion: Dialog öffnen

Dialog

Name der Visualisierung (Typ Dialog), die sich zur Laufzeit als Dialog öffnen wird, nachdem die Eingabeaktion vom Visualisierungsbenutzer ausgelöst wurde

: Auswahlliste mit allen im Projekt verfügbaren Dialogen

Anmerkung

Die Bibliothek VisuDialogs stellt Standarddialoge zur Verfügung.

VisuDialogs.FileOpenSave
VisuDialogs.Login

Übergabeparameter des Dialogs
Parameter	Schnittstellenparameter, so wie im Schnittstelleneditor der Visualisierung deklariert Beispiel: `filelistProvider`
Typ	Datentyp des Parameters, so wie im Schnittstelleneditor der Visualisierung deklariert Beispiel: `VISU_FBFILELISTPROVIDER`
Wert	Variable (Datentyp konform zum Datentyp des Parameters) Der Wert der Variablen wird beim Öffnen des Dialogs an den Parameter übergeben. Beispiel: `PLC_PRG.fileListProvider //Instance of function block VisuDialogs.Visu_FbFileListProvider` : Die Eingabeunterstützung bietet alle projektweit verfügbaren Variablen an.

Hier ist aktiviert, bei welchen Rückgabewert des Dialogs auf die `Var_OUTPUT`-Variablen und die `VAR_IN_OUT`-Variablen geschrieben wird. Danach schließt sich der Dialog.
Aktualisiereundfalls Ergebnis	Anmerkung Die Parameter werden aktualisiert, bevor der Dialog geschlossen wird. Bis dahin werden die Werte temporär abgelegt. Sie werden also nicht als Referenz sondern als Kopie verarbeitet.
Kein	: Bei keinem Rückgabewert
OK	: Legt fest, bei welchem Rückgabewert auf die Übergabeparameter geschrieben wird
Abbrechen
Beenden
Erneut versuchen
Ignorieren
Ja
Nein

Dialog modal öffnen

standard icon : Zur Laufzeit verarbeitet nur der Dialog Benutzereingaben. Benutzereingaben, die außerhalb des Dialogs auftreten, werden ignoriert. Die Oberfläche ist dort gesperrt.

Position für Öffnen	Initiale Position des sich öffnenden Dialogs bezogen auf die aufrufende Visualisierung
Zentriert	: Der Dialog wird in der Mitte angezeigt.
Position	: Der Dialog erscheint an der unten eingestellten Position. Hinweis: Verwenden Sie für die Angabe der Position in X- und Richtung jeweils die entsprechenden Eingabemöglichkeiten.
X	Horizontale X-Position für die obere linke Ecke des sich öffnenden Dialogs Eingabemöglichkeiten: fest in Pixel als IEC-Variable (ganzzahliger Datentyp) Platzhalter: `ElementRectangle.ptTopLeft.iX` Der Platzhalter wird durch die Position der oberen linken Ecke des Elements ersetzt. Platzhalter:`ElementRectangle.ptBottomRight.iX` Der Platzhalter wird durch die Position der unteren rechten Ecke des Elements ersetzt.
Y	Vertikale Y-Position für die obere linke Ecke des sich öffnenden Dialogs Eingabemöglichkeiten: fest in Pixel als IEC-Variable (ganzzahliger Datentyp) Platzhalter: `ElementRectangle.ptTopLeft.iY` Der Dialog erscheint zur Laufzeit an der Position der oberen linken Ecke des aufrufenden Elements Platzhalter:`ElementRectangle.ptBottomRight.iY` Der Platzhalter wird durch die Position der unteren rechten Ecke des Elements ersetzt.

Eingabeaktion: Sprachumschaltung

Clientabhängige Sprache

Die Sprache kann für jeden Client individuell umgeschaltet werden. Voraussetzung ist, dass das Add-on CODESYS Visualization mindestens in der Version 4.7.0.0 und das Laufzeitsystem in einer Version >= V3.5 SP20 installiert ist. Beim Start der Visualisierung wird diese in der im Browser eingestellten Sprache angezeigt (z. B. de, en). Diese Sprache muss im Projekt vorhanden sein. Ist die Sprache nicht vorhanden, werden die Standardtexte angezeigt.

Bis zur Version 4.6.0.0 erfolgte die Sprachumschaltung für alle Clients gleichzeitig.

Sprachkürzel

Verwenden Sie den ISO-639-Code (z. B. de, en, it, zh-CHS), um eine in der Visualisierung vorhandene Sprache zu benennen.

Sprache

Sprache, auf die der aktuelle Visualisierungs-Client umgeschaltet wird

Beispiel: en

: Die Eingabeunterstützung bietet alle im Projekt verfügbaren Sprachen an

Eingabeaktion: Visualisierungswechsel

Tabelle 110. Zu Visualisierung gehen

Visualisierung, die auf die Benutzereingabe hin dargestellt wird
Zuweisen	Visualisierung, ausgewählt aus allen verfügbaren Visualisierungen des Projekts oder der Bibliotheken Beispiel: `visMain`
Ausdruck zuweisen	Variable (`STRING`), die den Namen der Visualisierung enthält Beispiel: `PLC_PRG.strVisu` bei folgendem Applikationscode: `strVisu: STRING := 'visMain';`
Intern wird die Reihenfolge gespeichert, in der Visualisierungen nacheinander über Benutzereingaben angezeigt werden. Die folgenden beiden Optionen nutzen diese Information.
Vorherige Visualisierung	: Visualisierung, die vor der aktuell angezeigten schon angezeigt worden war Voraussetzung: Es gab bereits einen Visualisierungswechsel.
Nächste Visualisierung	: Visualisierung, die in der Aufrufreihenfolge nach der aktuellen steht Voraussetzung: Es gab bereits einen Visualisierungswechsel, der über Vorherige Visualisierung aufgerufen wurde.

Eingabeaktion: Befehl ausführen

Hier ist eine Liste mit Befehlen und deren Übergabeparameter konfiguriert, die die Visualisierung bei Eintreten des Eingabeereignisses abarbeitet.

Befehle konfigurieren

Programm auf der Steuerung ausführen
Programm beim Client ausführen
Drucken
Zu URL (WebVisu) navigieren
Rezeptur erstellen
Rezeptur lesen
Rezeptur schreiben
Rezeptur in Datei schreiben
Rezeptur aus Datei laden
Rezeptur löschen

Um den ausgewählten Befehl in die untere Befehlsliste einzutragen, klicken Sie auf das Symbol .

	Der Befehl unter Befehle konfigurieren wird in die Liste eingetragen
	Befehl wird entfernt Voraussetzung: Ein Befehl ist selektiert.
Die Reihenfolge in der Liste definiert die Reihenfolge der Ausführung.
	Der selektierte Befehl wird in der Liste um eine Position nach unten geschoben.
	Der selektierte Befehl wird in der Liste um eine Position nach oben geschoben.

Tabelle 111. Befehl: Programm auf der Steuerung ausführen

Befehl

1. Parameter

2. Parameter

ExecutePlcProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

EXE-Datei, die auf der Steuerung ausgeführt wird.

Das Programm wird auf der SPS ausgeführt und darf deshalb nicht interaktiv sein und es darf keine Benutzeroberfläche haben.

Möglich ist ein Programm, das zum Beispiel eine Datei kopiert.

Programmname mit Verzeichnis als String in einfachen Anführungszeichen

Argumente des Programms als String in einfachen Anführungszeichen

Beispiel: Name der Datei, die das Programm öffnet

Tabelle 112. Befehl: Programm beim Client ausführen

Befehl

1. Parameter

2. Parameter

ExecuteClientProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

EXE-Datei, die auf der Darstellungsvariante ausgeführt wird. Ausnahme: WebVisu!

Das Programme wird im Kontext der Darstellungsvariante ausgeführt. Somit darf das Programm interaktiv und mit Benutzeroberfläche sein.

Programmname mit Verzeichnis als STRING in einfachen Anführungszeichen

Argumente des Programms als STRING in einfachen Anführungszeichen

Beispiel: Name der Datei, die das Programm öffnet

Wichtig

Wenn die Visualisierung als CODESYS WebVisu dargestellt wird, kann kein Programm (EXE-Datei) gestartet werden.

Tabelle 113. Befehl: Zu URL (WebVisu) navigieren

Befehl

1. Parameter

2. Parameter

NavigateURL

'http://de.wikipedia.org'

PLC_PRG.stURL

'replace'

Die Visualisierung navigiert zur Webseite der URL.

Voraussetzung: Visualisierung wird als CODESYS WebVisuausgeführt.

. URL

Als Literal in einfache Anführungszeichen
Als Variable (STRING)

Wenn kein Parameter angebeben ist, wird die Webseite in einem neuen Fenster oder einer neuen Registerkarte dargestellt.

Wenn 'replace' angegeben ist, wird die CODESYS WebVisudurch die Webseite ersetzt.

Tabelle 114. Befehl: Rezeptur lesen

Befehl	1. Parameter	2. Parameter
`ReadRecipe`	`'RecipeDefinitionForModules'`	`'RecipeModuleA'`
	. Name der Rezepturdefinition Als Literal Als Variable (`STRING`)	. Name der Rezeptur Als Literal Als Variable (`STRING`)
Zur Laufzeit der Visualisierung werden die Istwerte aus den Variablen der Rezepturdefinition von der Steuerung gelesen und in die angegebene Rezeptur geschrieben. Dabei werden die Werte implizit (in einer Datei auf der Steuerung) gespeichert und in der Rezepturdefinition im Rezeptur-Manager in CODESYSangezeigt. In anderen Worten: Die in CODESYS verwaltete Rezeptur wird mit den Werten aus der Steuerung aktualisiert.

Tabelle 115. Befehl: Rezeptur schreiben

Befehl	1. Parameter	2. Parameter
`WriteRecipe`	`PLC_PRG.stRecipeDef`	`PLC_PRG.stRecipe`
	. Name der betroffenen Rezepturdefinition Als Literal Als Variable (`STRING`)	. Name der Rezeptur (aus der Rezepturdefinition) Als Literal Als Variable (`STRING`)
Zur Laufzeit der Visualisierung werden die Werte der Rezeptur, so wie sie im Rezeptur-Manager vorliegen, auf die Variablen in der Steuerung geschrieben.

Tabelle 116. Befehl: Rezeptur in Datei speichern

Befehl	1. Parameter	2. Parameter
`SaveRecipeAs`	`PLC_PRG.stRecipeDef`	`PLC_PRG.stRecipe`
	. Name der betroffenen Rezepturdefinition Als Literal Als Variable (`STRING`)	. Name der betroffenen Rezeptur, die aktualisiert und in einer Datei gespeichert wird. Als Literal Als Variable (`STRING`) Optionaler Parameter: Wenn Sie hier keinen Übergabeparameter angeben, werden die Werte aus den Rezepturvariablen nur in der danach angegebenen Datei gespeichert. Die impliziten Rezepturdateien werden nicht aktualisiert.
Zur Laufzeit der Visualisierung öffnet der Dialog Save Recipe as und fordert den Benutzer auf einen Speicherort auf der Steuerung und einen Dateinamen anzugeben. Der Dateiname darf nicht `<Rezeptur>.<Rezepturdefinition>` sein. Die Dateierweiterung ist `.txtrecipe`. Der Benutzer kann dann die Datei, die die Istwerte aus den Rezepturvariablen enthält, speichern. Wenn im 2. Parameter kein Übergabeparameter angegeben ist, wird die Datei gespeichert ohne eine implizite Rezepturdatei zu ändern. Wenn im 2. Parameter ein Übergabeparameter angegeben ist, wird auch die implizite Rezepturdatei aktualisiert. Hinweis: Wenn die Option Rezepturänderungen automatisch in Rezepturdateien speichern in Registerkarte Rezeptur-Manager - Allgemein aktiviert ist, ist die Rezepturdefinition in CODESYS und die impliziten Rezepturdateien automatisch gleich. Hinweis: Auf der Steuerung befinden sich implizite (automatisch erstellte) Rezepturdateien mit Namen `<Rezeptur>.<Rezepturdefinition>.txtrecipe`. Sie dienen üblicherweise der Applikation als Zwischenablage beim Lesen und Schreiben von Rezepturvariablen.

Tabelle 117. Befehl: Rezeptur aus Datei laden

Befehl	1. Parameter	2. Parameter
`LoadRecipeFrom`	`PLC_PRG.stReccipeDef`	`PLC_PRG.stReccipe`
	. Name der betroffenen Rezepturdefinition Als Literal Als Variable (`STRING`)	. Name der betroffenen Rezeptur Als Literal Als Variable (`STRING`)
Zur Laufzeit der Visualisierung öffnet der Dialog Load Recipe. Er bietet dem Visualisierungsbenutzer eine Liste mit Dateien an, die auf dem Dateisystem der Steuerung liegen und filtert nach der Erweiterung `txtrecipe`. Die ausgewählte Datei wird geladen. Die Rezepturen aus der Datei werden dann in die impliziten Dateien geschrieben und im Rezeptur-Manager in der angegebenen Rezepturdefinition in der angegebenen Rezeptur eingelesen. Voraussetzung: Die Datei wurde mit dem Befehl `SaveRecipeAs` erstellt.

Tabelle 118. Befehl: Rezeptur erstellen

Befehl	1. Parameter	2. Parameter
`CreateRecipe`	`PLC_PRG.stRecipeDef`	`PLC_PRG.stRecipe_New`
	. Name der betroffenen Rezepturdefinition Als Literal Als Variable (STRING)	. Name der neuen Rezeptur Als Literal Als Variable (STRING)
Zur Laufzeit der Visualisierung wird in der angegebenen Rezepturdefinition eine neue Rezeptur erstellt.

Tabelle 119. Befehl: Rezeptur löschen

Befehl	1. Parameter	2. Parameter
`DeleteRecipe`	`PLC_PRG.stRecipeDef`	`PLC_PRG.stRecipe`
	. Name der betroffenen Rezepturdefinition Als Literal Als Variable (`STRING`)	. Name der Rezeptur Als Literal Als Variable (`STRING`)
Zur Laufzeit der Visualisierung wird die angegebene Rezeptur aus der angegebenen Rezepturdefinition gelöscht.

Tabelle 120. Befehl: Drucken

Befehl	1. Parameter	2. Parameter
`Print`	Optional: Dateinamen für das Visualisierungsbild, das gedruckt wird, zum Beispiel: ‚Startbild‘	Für den Befehl `Print` kann kein 2. Parameter angegeben werden.
Zur Laufzeit der Visualisierung öffnet sich der Standarddialog Drucker. In dem Dialog wählen Sie einen Drucker aus und konfigurieren Sie weitere Druckeinstellungen. Wenn Sie den Dialog bestätigen, wird das aktuell dargestellte Visualisierungsbild gedruckt. Anmerkung Der Befehl kann nur in der TargetVisu ausgeführt werden.

Eingabeaktion: Framevisualisierung umschalten

Bei Auftreten des Eingabeereignisses schaltet in einem Frame die Darstellung auf eine andere Visualisierung um.

Auswahlart
Lokale Visualisierung	Die Gruppe Frameauswahl ist sichtbar
Beliebige Visualisierung	Die Gruppe Auswahl von Frame und Visualisierung ist sichtbar

Voraussetzung: Lokale Visualisierung ist aktiviert
Frameauswahl	Liste mit allen Frames, die die aktive Visualisierung enthält. Unter jedem Frame sind die referenzierten Visualisierungen aufgelistet, so wie sie auch in der Eigenschaft Referenzierte Visualisierungen des jeweiligen Frames festgelegt sind. Beispiel:
Auswahl zuweisen	Die Auswahl in Eingabefeld Frame-Auswahl wird übernommen und erscheint in den Einstellungen Ausgewählter Frame und Ausgewählte Visualisierung. Voraussetzung: Sie haben in Eingabefeld Frame-Auswahl eine Visualisierung selektiert!
Auswahl des Frames	Name des Frames, in dem umgeschaltet wird Beispiel: `MainArea` Tipp: Verwenden Sie den Befehl Auswahl zuweisen um die Einstellung hier zu ändern.
Visualisierungsauswahl	Name der Visualisierung, auf die umgeschaltet wird Beispiel: `visMainArea` Tipp: Verwenden Sie den Befehl Auswahl zuweisen um die Einstellung hier zu ändern.

Voraussetzung: Beliebige Visualisierung ist aktiviert.
Auswahl von Frame und Visualisierung	Enthält den Frame, in dem umgeschaltet wird
Zuweisen	Frame mit vollständigem Pfad, in dem umgeschaltet wird. Auf welche Visualisierung bestimmt der Index. Beispiel: `visMain.frameA.visB.frameB` Die Pfadangabe erfolgt im Format: `<Visualisierungsname>.<Framename> { <Visualisierungsname>.<Framename> }` Vorsicht: Visualisierungen können mit Hilfe von Frame-Elementen beliebig tief verschachtelt sein. Um den Frame-Auswahltyp Beliebige Visualisierung umschalten problemlos nutzen zu können, darf ein Frame jedoch nicht mehr als 21 referenzierte Visualisierungen enthalten.
Ausdruck zuweisen	Variable (`STRING`) für den Pfad des Frames, in dem umgeschaltet wird Beispiel: `strFrane: STRING := 'visMain.frameA.visB.frameB';`
Auszuwählender Index	. Index, der bestimmt, welche der referenzierten Visualisierungen dargestellt wird Als ganze Zahl Als Variable (ganzzahliger Datentyp) Beispiel :`PLC_PRG.iIndex` Hinweis: Die referenzierten Visualisierungen eines Frames werden über ihre Reihenfolge automatisch indiziert.

Voraussetzung: Das Projekt enthält Visualisierungen, die eine Struktur bilden.

Eingabeaktion: Variable schreiben

Die Konfiguration der Eingabeaktion bestimmt, wie ein Visualisierungsbenutzer einen Wert eingibt und auf welche Variable der Wert geschrieben wird.

Eingabetyp Art und Weise, wie zur Eingabe aufgefordert wird
Standard	Eingabefeld oder bei Bedarf (wenn die Darstellungsvariante über keine Hardwaretastatur verfügt) eine virtuelle Tastatur Hinweis: Die Standardmöglichkeit für eine Texteingabe zur Laufzeit ist im Visualisierungsmanager festgelegt: Registerkarte Dialog-Einstellungen, Einstellungen für die Standardtexteingabe.
Texteingabe	Ein Eingabefeld erscheint. Als Visualisierungsbenutzer können Sie eine Zahl oder einen Text über Tastatur eingeben. Voraussetzung: Die Darstellungsvariante verfügt über eine Tastatur als Eingabegerät.
Texteingabe mit Grenzen	Ein Eingabefeld erscheint. Sie können eine Zahl oder einen Text über Tastatur eingeben. Das Feld zeigt zusätzlich den Wertebereich für die Eingabe an. Bei Unterschreiten oder Überschreiten wird der Eingabewert rot dargestellt. Voraussetzung: Die Darstellungsvariante verfügt über eine Tastatur als Eingabegerät.
VisuDialogs.Keypad	Eine virtuelle Tastatur erscheint. Sie können damit eine Zahl oder einen Text eingeben.
VisuDialogs.Numpad	Eine virtuelle Tastatur erscheint. Sie können damit eine Zahl eingeben.
VisuDialogs.NumpadExtended	Eine virtuelle Tastatur erscheint. Sie können damit eine Zahl eingeben. Hier ist auch das Hexadezimal- oder Exponentialformat erlaubt.

Variable zur Bearbeitung auswählen
Textausgabevariable verwenden	: Der Eingabewert wird in die Textausgabevariable des Elements geschrieben. Das ist die Variable, die In der Eigenschaft Textvariable → Text zugewiesen ist.
Andere Variable verwenden	: Variable, auf die der Eingabewert geschrieben wird Beispiel: `PLC_PRG.iVariable`
Initiales Darstellungsformat	Platzhalter mit Formatierungsangabe. Sie bestimmt das Ausgabeformat für den Variablenwert und für die Eingabegrenzen. Beispiel: `%2.3f` für die Darstellung des Werts als Dezimalbruch mit Komma.

Min	. Minimalwert der Eingabegrenze. Wenn ein Benutzer einen kleineren Wert eingibt, wird er nicht übernommen. als fester Wert als Variable (Datentyp konform zur ausgewählten Variable)
Max	. Maximalwert der Eingabegrenze. Wenn ein Benutzer einen größeren Wert eingibt, wird er nicht übernommen. als fester Wert als Variable (Datentyp konform zur ausgewählten Variable)
Dialogtitel	. Text, der in der Titelleiste des Dialog angezeigt wird. Optional. als fester String Beispiel: `Insert value` als Variable (`STRING`) Beispiel `PLC_PRG.stTitel : STRING := 'Insert value';`

Passwort-Feld

standard icon : Unsichtbare Texteingabe: Statt des eingegebenen Texts wird *** dargestellt.

Position für Öffnen des Eingabedialogs	Initiale Position für den sich öffnenden Eingabedialog bezogen auf die aufrufende Visualisierung
Globale Einstellungen verwenden (vom Visualisierungsmanager)	Voraussetzung: Diese Option ist nur bei Darstellung auf einer TargetVisu oder als WebVisu verfügbar. : Es wird die im Visualisierungsmanager in der Registerkarte Dialogeinstellungen eingestellte Position verwendet.
Zentriert	: Der Dialog wird in der Mitte angezeigt.
Position	: Der Dialog erscheint an der unten eingestellten Position. Hinweis: Verwenden Sie für die Angabe der Position in X- und Richtung jeweils die entsprechenden Eingabemöglichkeiten.
X	Horizontale X-Position für die obere linke Ecke des sich öffnenden Dialogs Eingabemöglichkeiten: fest in Pixel als IEC-Variable (ganzzahliger Datentyp) Platzhalter: `ElementRectangle.ptTopLeft.iX` Der Platzhalter wird durch die Position der oberen linken Ecke des Elements ersetzt. Platzhalter:`ElementRectangle.ptBottomRight.iX` Der Platzhalter wird durch die Position der unteren rechten Ecke des Elements ersetzt.
Y	Vertikale Y-Position für die obere linke Ecke des sich öffnenden Dialogs Eingabemöglichkeiten: fest in Pixel als IEC-Variable (ganzzahliger Datentyp) Platzhalter: `ElementRectangle.ptTopLeft.iY` Der Platzhalter wird durch die Position der oberen linken Ecke des Elements ersetzt. Platzhalter:`ElementRectangle.ptBottomRight.iY` Der Platzhalter wird durch die Position der unteren rechten Ecke des Elements ersetzt.

Eingabeaktion: ST-Code ausführen

Eingabefeld

Editor für Code als strukturierter Text

Eingabeaktion: Variable umschalten

Variable

Variable (BOOL) , die bei Eintritt des Eingabeereignisses umgeschaltet wird

Beispiel: PLC_PRG.bSwitch

Eingabeaktion: Dateiübertragung

Mit der Eingabeaktion Dateiübertragung kann eine Datei von einer Bedienvariante (Target- oder Webvisualisierung) sowohl von als auch zur SPS übertragen werden. Dies funktioniert entweder mittels Dateitransfer (Typ: Datei) oder mittels Streaming (Typ: Streaming).

Die Aktion bewirkt, dass zur Laufzeit in der Visualisierung ein Dateiauswahldialog erscheint. Dort kann der Visualisierungsbenutzer eine Datei auswählen, die entweder von oder zur SPS übertragen werden wird: Bei der Übertragung von einer SPS zur Visualisierung öffnet sich der Dialog Datei speichern. Bei der Übertragung von der Visualisierung zur SPS öffnet sich der Dialog Datei öffnen.

Übertragung
Richtung	Richtung der Dateiübertragung
Von der SPS zur Visualisierung	Das in Dateiname oder Streaming Instanzname bestimmte Objekt wird von der SPS zur Visualisierung übertragen. Zur Laufzeit erscheint in der Visualisierung der Dateiauswahldialog Datei speichern.
Von der Visualisierung zur SPS	Die vom Visualisierungsbenutzer bestimmte Datei wird zur SPS übertragen und dort unter dem in Dateiname oder Streaming Instanzname angegebenen Dateipfad gespeichert. Zur Laufzeit erscheint in der Visualisierung der Dateiauswahldialog Datei öffnen.

Typ	. Legt fest, wie die Datei übertragen wird Übertragungstyp Datei: mittels Dateitransfer Übertragungstyp Streaming: mittels Streaming

Typ

Datei

Die Datenübertragung erfolgt mittels Dateitransfer.

Dateiname

Dateipfad (Typ STRING), der die Datei im Dateisystem der Steuerung bezeichnet

Variable
Beispiel: strTransferFile: STRING;
Literal mit relativem Pfad
Beispiel: '/Recipes/Recipe_1.txt' speichert die Datei im Verzeichnis Recipes
Literal mit Platzhalter $PLCLOGIC$
PlcLogic ist die Standardauflösung für den Verzeichnisplatzhalter $PLCLOGIC$ .
Beispiel: '$$PLCLOGIC$$/test.txt' legt die Datei im Verzeichnis PlcLogic ab.
Beispiel: '$$PLCLOGIC$$/MyData/test.txt' legt die Datei im Unterverzeichnis PlcLogic/MyData ab.
Literal mit Platzhalter $VISU$
visu ist die Standardauflösung für den Platzhalter $VISU$ .
Beispiel: '$$VISU$$/test.txt' legt die Datei im Unterverzeichnis PlcLogic/visu ab. Alternativ kann 'visu/test.txt' angegeben werden.
Literal mit absolutem Pfad
Beispiel: 'E:\\temp\\test.txt'
Hinweis: Solche Dateipfade werden nicht immer unterstützt.

Anmerkung

Wenn in der Visualisierung der Dateipfad von einem Benutzer mit Hilfe eines Textfeld-Elements eingegeben wird, muss das Maskierungszeichen $ nicht angegeben werden: $VISU$/dummy.txt

Anmerkung

Im Fall, dass der Dateipfad vom Benutzer eingegeben wird, sollte dieser von der Applikation geprüft werden, um das Auslesen oder Überschreiben unerwünschter Dateien zu vermeiden.

Typ

Streaming

Die Datenübertragung erfolgt über Streaming.

Streaming Instanzname

Instanzpfad (Typ IVisuStreamWriter oder IVisuStreamReader), der das Objekt im Dateisystem der Steuerung bezeichnet

Typ IVisuStreamReader bei Übertragungsrichtung Von der SPS zur Visualisierung

Typ IVisuStreamWriter bei Übertragungsrichtung Von der Visualisierung zur SPS

Steuerflags

Hinweis: Die Variable wird nur bei der Übertragungsrichtung Von der Visualisierung zur SPS ausgewertet.

Variable (Typ DWORD)

Bestimmt, wie das Objekt (Datei oder Instanzobjekt) auf dem Dateisystem der SPS behandelt wird. Dafür stehen zwei Flags zur Verfügung, mit denen die Variable gesetzt werden kann.

Flag 1: VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName
Flag 2: VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc

. Optionen

Kein Flag gesetzt:
Der Benutzer wählt eine Datei aus, die unter dem in Dateiname oder Streaming Instanzname angegebenen Pfad abgelegt wird
Flag 1 ist gesetzt:
Der Pfad, der zur Laufzeit der Visualisierung vom Benutzer eingegeben wird, wird übernommen und als Pfad im SPS-Dateisystem verwendet
Beide Flags sind gesetzt:
Der Pfad wird zusätzlich geprüft. Wenn unter dem auf Client-Seite angegebenen Pfad bereits ein Objekt vorhanden ist, erscheint in der Visualisierung eine Meldung mit einer Abfrage. Dort kann der Visualisierungsbenutzer das Überschreiben der Datei bestätigen.

Beispiel: dwControlFlag

Beispiel 49. Beispiel

Die Übertragungsrichtung ist Von der Visualisierung zur SPS (Schreiben).

Beispiel: Auf dem Visualisierungsgerät ist eine neue Rezepturdatei Recipes/Recipe_2021.txt erstellt worden. Der Visualisierungsbenutzer wählt diese Datei aus und möchte, dass diese auf der SPS unter diesem Namen abgespeichert wird. Da die Kontroll-Flags entsprechend gesetzt sind, öffnet sich ein Meldungsfenster und Visualisierungsbenutzer kann das Überschreiben der Datei bestätigen.

PROGRAM PLC_PRG
VAR
    xVisuToggle : BOOL;
    dwControlFlag : DWORD := VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName
                             + VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc;
    strFileName: STRING := '/Recipes/Recipe_new.txt';
END_VAR

Statusvariablen
Übertragung läuft	Boolesche Variable (optional) `TRUE`: Die Übertragung läuft
Übertragung erfolgreich	Boolesche Variable (optional) `TRUE`: Die Übertragung ist erfolgreich beendet
Fehlercode	`0`:\ Kein Fehler `1`:\ Nicht näher spezifizierter Fehler `2`:\ Abbruch des Dateidialogs `3`:\ Andere Dateiübertragung aktiv `4`:\ Fehler während der Dateiübertragung `5`:\ Abbruch durch Timeout `6`:\ Dateilesefehler – Die Datei ist nicht vorhanden oder kann nicht gelesen werden `7`: Keine Geräteunterstützung für die Dateiübertragung Mögliche Ursachen: CODESYS WebVisu : Dateiübertragung standardmäßig nicht möglich Kommunikation mit einer Steuerung der Version < 3.5.11: Funktionalität ist nicht implementiert Kommunikation mit einer Steuerung der Version >= 3.5.11: Dateiübertragung ist nicht freigeschaltet (Geratebeschreibung) Tipp CODESYS verwaltet diese Einstellung in den Projekteinstellungen.

Verwenden Sie das Dialogfeld, um die Datei auszuwählen

Voraussetzung: Die Option ist verfügbar, wenn als Richtung Von der Visualisierung zur SPS angegeben wurde.

: Der Dateiauswahldialog des Betriebssystems erscheint unmittelbar (Standard für neu angelegte Eingabeaktion)

: Der standardmäßig verfügbare Dialog für den Dateitransfer erscheint und fordert zur Auswahl einer Datei auf. Sie können den Dialog anpassen.
Tipp: Es ist möglich, dass der Dialog an ungünstiger Stelle erscheint, und dass das Dialog-Layout nicht dem der Oberfläche der Webvisualisierung entspricht.

In diesem Abschnitt:

Siehe auch:

Dialog: Eingabekonfiguration

Sind alle Elementeigenschaften verfügbar?

Eingabeaktion: Benutzerverwaltung

Anmerkung

Eingabeaktion: Dialog schließen

Anmerkung

Anmerkung

Eingabeaktion: Dialog öffnen

Anmerkung

Anmerkung

Eingabeaktion: Sprachumschaltung

Clientabhängige Sprache

Sprachkürzel

Eingabeaktion: Visualisierungswechsel

Eingabeaktion: Befehl ausführen

Wichtig

Anmerkung

Eingabeaktion: Framevisualisierung umschalten

Eingabeaktion: Variable schreiben

Eingabeaktion: ST-Code ausführen

Eingabeaktion: Variable umschalten

Eingabeaktion: Dateiübertragung

Anmerkung

Anmerkung

Tipp

Suchresultat